MC-10 Operation and Language Reference Manual Chapter 9

9/STOP, LOOK, AND LISTEN Numeric Variables Do you have a program currently in memory? If you do, add one more line to finish it. For instance: 100 END Whenever the Micro Color BASIC encounters the command END in a program, it immediately stops. Of course, if there are no other instructions at the end of a program, it will stop anyway; but good programming practices dictate that you should always end your program with END.
END
Sometimes, you may want to put the END command in the middle of a program, especially if you're using "subroutines" (more on those later). Here's an example of how you might want to use END: 10 PRINT "THIS IS THE TEST FOR 'END'" 20 PRINT "THIS LINE WILL BE PRINTED" 30 END 40 PRINT "BUT THIS LINE WON'T" 50 END Now RUN it. Your TV will display this: THIS IS THE TEST FOR 'END' THIS LINE WILL BE PRINT OK There Has To Be An Easier Way... Notice that the Control Command key sequence of: [CONTROL][:] will also display the END command. The STOP Command A close cousin of END is the STOP command.
STOP
STOP also halts program execution. However, it is generally used inside the program instead of at the end. The sample program used above would be a more "correct" program if it used STOP like this: 10 PRINT "THIS IS THE TEST FOR 'END'" 20 PRINT "THIS LINE WILL BE PRINTED" 30 STOP 40 PRINT "BUT THIS LINE WON'T" 50 END When you RUN the program with line 30 changed to STOP, the results are almost the same: THIS IS THE TEST FOR 'END' THIS LINE WILL BE PRINTED BREAK IN 30 OK This points out the main difference between STOP and END. With END Micro Color BASIC assumes the program has ended. With STOP, the program has simply been interrupted. There Has To Be An Easier Way... Instead of typing in the command STOP everytime you want to use it, simply press the key-combination of: [CONTROL][-] and STOP will appear on the Screen. The [BREAK] Key Pressing [BREAK] during program execution is another way of stopping program execution. While STOP halts program execution "automatically", pressing [BREAK] halts it "manually". When you press [BREAK], a message similar to the following is displayed" BREAK IN 30 OK The CONT Command Once a program has been interrupted by STOP or END, or by pressing [BREAK], you can continue program execution with the CONT ("continue") command.
CONT
CONT is handy to use in the Immediate Mode when you're trying to find out what's wrong with ("debug") a program. For instance, you already know what will happen if you execute the following program: 10 PRINT "THIS IS THE TEST FOR 'END'" 20 PRINT "THIS LINE WILL BE PRINTED" 30 STOP 40 PRINT "BUT THIS LINE WON'T" 50 END The TV will display: THIS IS THE TEST FOR 'END' THIS LINE WILL BE PRINTED BREAK IN 30 OK At this point, type: CONT [ENTER] and the rest of the program will be executed: BUT THIS LINE WON'T OK There Has To Be An Easier Way... To use CONT without typing it in, press the key-combination of: [CONTROL][2] and then press [ENTER]. The CLS Command Are you tired of pressing RESET to clear the Screen? Why not let the MC-10 clear its own Screen. To do this, use the CLS ("Clear Screen") command.
CLS (color-code) color-code specifies the background color of the TV SCREEN and is a numeric expression between 0 and 8. color-code is optional, if omitted, 1 is used. Note: The ( ) are optional.
CLS will clear the Screen, while leaving the current contents of memory intact. If you simply type in CLS [ENTER], Micro Color BASIC will clear the Screen with the normal, default color (green). If you include a number between 0-8 after the command (see Table 3), the Screen will be cleared in the specified color. For instance, if you type CLS 8 [ENTER] (remember that the parentheses are not required), the Screen will turn orange. Now you know for sure that it's a "color computer". Why is there a green stripe across the top? Because the MC-10 cannot display regular characters on anything but a green background. (Graphics Characters are a different story however.) Note that if color-code is a number greater than 8, the message MICROSOFT or a ?FC ERROR will appear and the Screen will turn green. CLS is a useful command to use at the beginning of a program when you want the program listing (or any other display) to be erased.
Code | For This Color
0 | black
1 | green
2 | yellow
3 | blue
4 | red
5 | buff
6 | cyan
7 | magenta
8 | orange
Table 3
There Has To Be An Easier Way... To enter the CLS command the easy way, press the key-combination of: [CONTROL][8] You can then either type in a color code and press [ENTER] or just press [ENTER] for a green Screen. Add CLS to a program by typing: 5 CLS [ENTER] When you list the program, the TV will display: 5 CLS 10 PRINT "THIS IS MY FIRST MC-10 PROGRAM" 20 PRINT "THIS IS THE SECOND LINE" 50 END When you RUN it this time, the Screen will automatically clear. The SOUND Command Since a TV has sound capabilities, and since the MC-10 was designed to be connected to it, your Computer can also generate audio output. To produce a sound, use the Micro Color BASIC SOUND command.
SOUND tone, duration tone specifies the sound you wish to generate and is a numeric expression between 1 and 255. duration specifies the length of time tone is to be generated and is a numeric expression between 1 and 255. 1 is approximately 7.5/100 of a second. Both tone and duration must be specified.
Before using SOUND, be sure the volume is set to normal listening range. Type in this: SOUND 1,100 [ENTER] When you press [ENTER]. the Computer's lowest tone will be produced for 7.5 seconds. Want to try the highest tone? Try this: SOUND 255,100 [ENTER] That, as they say, is the other end of the sound spectrum. Try some other numbers, but don't exceed the 1-255 range for either tone or duration or you'll get an ?FC ERROR. And don't forget, both tone and duration must be included or a ?SN ERROR will occur. The REM Statement Are you ready for a different type of program? Type in this: 10 REM THIS IS MY 2ND PROGRAM 20 REM IT USES "REM" LIST the program and check for typing errors-especially in the spelling of REM. Now RUN the program. Nothing happened, right? No error messages appeared and the OK prompt returned.
REM message message can be any information you want displayed.
The REM ("remark") statement allows you to include extraneous information in a program line without generating an error message. What happens is that any time Micro Color BASIC encounters a REM statement, it simply ignores everything that comes after it. You'll find REM a handy way to include explanatory messages within programs or program lines. Note that REM can be used in the middle of a program line as long as it is preceded by a colon (:). The following are all valid uses of REM: 10 REM ARITHMETIC PROGRAM 20 PRINT 10 + 5 :REM ADDITION 30 PRINT 10 - 5 :REM SUBTRACTION 40 PRINT 10 / 5 :REM DIVISION 50 PRINT 10 * 5 :REM MULTIPLY 60 END

Comments should be directed to the following email address:
dsbrain@neosplice.com